The AT+CPBW write command can be used to create, edit and delete a phonebook entry at a
<location> of the active storage selected with
AT+CPBS.
If
<storage>="FD" (SIM fixed dialing numbers) is selected, PIN2 authentication has to be performed prior to any write access.
The
AT+CPBW test command returns the location range supported by the current storage, the maximum length of the
<number> field, the range of supported
<type> values and the maximum length of the
<text> field. Note: The length may not be available while SIM storage is selected. If storage does not offer format information, the format list contains empty parenthesizes.
Phone number in format specified by <type>. Parameter must be present, although it may be an empty string. Alphabetic characters are not permitted.
<number> may contain dialstring modifiers "*", "#" or "+".
If other printable non-alphabetic characters are used the entry needs to be saved with
<type>=209. Otherwise, if
<type>=209 is not used any non-digit characters other than "*", "#" or "+" will be removed from the string and only accepted modifiers from the GSM alphabet will be saved.
A
<number> saved with
<type>=209 requires double memory. In order to fit into a standard location, the number needs to be reduced to a maximum length of
<nlength>/2, including all digits and dial string modifiers. Extended locations may be used as stated below for
<nlength>.
Dialing string <number> will be saved as ASCII string.
This is the default value, if
<type> is not specified explicitly and characters other than "*", "#" or "+" are included in
<number>.
Note that phonebook entries saved with this type cannot be dialed.
Dialing string <number> is a command to control a Supplementary Service, i.e. "*", "#" codes are contained. Network support of this type is optional.
Maximum length of <text> assigned to the telephone number. The value indicated by the test command is given in octets. If the
<text> string is given in GSM characters, each character corresponds to one octet. If the
<text> string is given in UCS2, the maximum number of characters depends on the coding scheme used for the alpha field of the SIM. In the worst case the number of UCS2 characters is at least one less than half the number of GSM characters.
For a detailed description please refer to GSM 11.11, Annex B
[26].
|
EXAMPLE 1
|
Make a new phonebook entry at the first free location
|
|
EXAMPLE 2
|
Delete entry at location 1
|
|
EXAMPLE 3
|
The following examples are provided to illustrate the effect of writing phonebook entries with different types of dial string modifiers in <number>
|
|
EXAMPLE 4
|
Read phonebook entries from locations 5 - 9 via AT+CPBR
|